Skip to main content

​
Create your Pesaswap account and add a payment provider via the Control Center.

​
Getting Started – Login / Register

During the local setup, a user is automatically configured for you. You can use the following credentials to access the dashboard. On the landing page, click the Sign Up button. Enter your email and set a strong password, then click Sign Up. This process will:
  • Create a user with the provided email address
  • Automatically create and tag a merchant account to the user
To view your profile and account information, click your email address at the bottom of the left navigation bar.

​
Create an API Key

  1. From the left nav bar, go to Developers → Keys
  2. Click Create API Key
  3. A popup will appear. Enter a description and define the validity period for the key
  4. Click Next to generate the key
An API key will be created with options to download or copy it.
Be sure to download or copy the API key immediately. It is only shown once for security reasons. If you miss it, you will need to create a new key.

​
Add a Payment Processor

From the left nav bar, navigate to the Processors tab. You’ll see a list of payment processors already integrated with Pesaswap. To connect one:
  1. Select the processor you want to integrate
  2. Provide credentials, such as the API key and secret (varies by processor)
  3. Configure the Pesaswap webhook endpoint in the processor’s dashboard to receive payment updates
  4. Enable payment methods like cards, wallets, etc., within the processor settings
  5. Review and confirm your connection

​
Set Up Smart Routing

Pesaswap Control Center gives you full control over how and where your payments are routed. Navigate to Workflow → Routing from the left nav bar to access the Smart Routing module. By default, a priority-based routing based on the processor created time (first connected processor with highest priority) is enabled for you. This also acts as your fallback routing - which means if all else fails, routing will follow this priority. Currently, you can configure two types of routing with more on the way:

​
Default Behavior:

A priority-based routing system is enabled by default. The first connected processor has the highest priority and acts as a fallback in case others fail.

​
Routing Options:

​
Pesaswap currently supports:

1. Volume-Based Routing Assign percentage-based volumes to each connected processor. Pesaswap will distribute traffic to maintain the configured ratio. As the name suggests, this routing is based on the volume provided. You can assign percentage volumes that needs to be processed with the connected processors and Pesaswap will route in a way to ensure that the volume distribution is maintained Example:
  • 70% to Processor A
  • 30% to Processor B
2. Rule-Based Routing Rule based routing gives you finer control over payment routing. It exposes payment parameters like amount, payment_method, card_type etc. with which you can configure multiple rules. Rule based routing also provides an option to enable default processors through which the routing will happen in case the rule fails. Gain granular control by defining custom rules based on payment attributes like:
  • amount
  • payment_method
  • card_type
  • … and more
You can also configure default processors to fall back on if no rules match.